home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / hardware / vector-connection / development / autodocs / vectorpar.doc < prev    next >
Encoding:
Text File  |  1995-03-09  |  2.9 KB  |  87 lines
  1. TABLE OF CONTENTS
  2.  
  3. vectorpar.device/PIOCMD_ACTIVE
  4. vectorpar.device/PIOCMD_INACTIVE
  5. vectorpar.device/PIOCMD_ACTIVE                 vectorpar.device/PIOCMD_ACTIVE
  6.  
  7.    NAME
  8.     PIOCMD_Active -- restarts the device related activities of the chip
  9.  
  10.    FUNCTION
  11.     This command returns a parallel channel back to the active ('normal') state.
  12.  
  13.    IO REQUEST
  14.     io_Message      mn_ReplyPort initialized
  15.     io_Device       preset by OpenDevice
  16.     io_Unit         preset by OpenDevice
  17.     io_Command      PIOCMD_ACTIVE (0C)
  18.  
  19.    RESULT
  20.     io_Error -- 0              if Unit was restarted.
  21.                 ParErr_NotOpen if Unit was not inactive.
  22.  
  23.    NOTES
  24.     If the Unit is restarted, then the unit is re-initialized. So don't
  25.     expect your queued requests to be executed. You should definitely
  26.     not mix normal device access and this Active/Inactive access without
  27.     a CloseDevice()/OpenDevice() sequence in between.
  28.  
  29.     This is not a nesting call. One PIOCMD_Active will end all PIOCMD_INACTIVE
  30.     Calls.
  31.  
  32.    SEE ALSO
  33.     vectorpar.device/PIOCMD_INACTIVE
  34.  
  35. vectorpar.device/PIOCMD_INACTIVE             vectorpar.device/PIOCMD_INACTIVE
  36.  
  37.    NAME
  38.     PIOCMD_Inactive -- renders the parallel unit inactive and returns
  39.     pointer to chip and unit.
  40.  
  41.    FUNCTION
  42.     This command allows the caller to set a channel into 'inactive' mode.
  43.     After calling this function you can bang the hardware of the channel
  44.     for e.g. parallel SANA II drivers or digitizer hardware.
  45.  
  46.    IO REQUEST
  47.     io_Message      mn_ReplyPort initialized
  48.     io_Device       preset by OpenDevice
  49.     io_Unit         preset by OpenDevice
  50.     io_Command      PIOCMD_INACTIVE (0B)
  51.  
  52.    RESULT
  53.     io_Length -- points to the base address of the chip
  54.     io_Actual -- points to the relative base of the unit
  55.  
  56.    NOTES
  57.     Your channel will be Interrupt-Disabled; you can bang the hardware as
  58.     much as you want. You can use the chip-interrupt (The chip can generate
  59.     a PORTS interrupt), but you must add your Interrupt node to the handler
  60.     chain at priority 11 or above. (The interrupt node is currently at
  61.     Priority 0, *but this can change up to Priority 10*, so be warned.
  62.  
  63.     You should definitely read an 68230 Hardware manual before starting to
  64.     to program the chip. 
  65.  
  66.     You will get two pointers for the chip:
  67.  
  68.     a) a pointer to the chip base. This can be an odd value, so don't
  69.        try word or long accesses to the chip. You can also use the pio
  70.        structure from vector/vectorpar_hard.h
  71.  
  72.     b) a pointer to the unit of the chip. This can be an odd value, too.
  73.        This is a pointer to the DDR of a channel. All other channel related
  74.        registers can be accessed relative to this address. You can also use
  75.        the pchannel structure from the vector/vectorpar_hard.h includefile.
  76.  
  77.     The chip is (due to its 8 Bit heritage) only on one kind of adresses
  78.     (even or odd), so you will have a pad-byte between two registers.
  79.  
  80.    BUGS
  81.     This is not a nesting call. If you call it once, every other command
  82.     will fail with ParErr_DevBusy.
  83.  
  84.    SEE ALSO
  85.     vectorpar.device/PIOCMD_ACTIVE
  86.  
  87.